home *** CD-ROM | disk | FTP | other *** search
/ Programming Sound Cards / Programming Sound Cards.iso / sound_27 / fzedit.doc next >
Text File  |  1995-01-01  |  12KB  |  285 lines
  1.  
  2.  
  3.  
  4.  
  5.                                     FZEDIT
  6.  
  7.                            FZ-1/10M Parameter Editor
  8.  
  9.  
  10.                                   Version 1.0
  11.                                  June 20, 1989
  12.  
  13.  
  14. Overview:
  15. --------
  16.  
  17. FZEdit displays EVERY parameter in a full, bank, voice, effect, or
  18. parameter file created using the FZCom utility.  FZEdit can also
  19. exchange parameter data directly with the FZ-1/10M via MIDI.  FZEdit
  20. includes all of the capabilities of the FZList utility plus the ability
  21. to edit a number of individual and global parameter values.  FZEdit is
  22. not designed to be a complete remote editor for the FZ-1/10M.  Instead,
  23. it supports editing that is difficult or impossible to perform using the
  24. FZ's own menu-based editing facilities.  New editing capabilities are
  25. being regularly added, and suggestions for useful capabilities are
  26. welcomed.
  27.  
  28.  
  29. System Requirements:
  30. -------------------
  31.  
  32. IBM PC or compatible.  MIDI interface to FZ-1/10M (MPU-401 or compatible
  33. operating in UART mode) required for FZCom and for FZEdit FZ-1/10M MIDI
  34. parameter exchange.
  35.  
  36. Microsoft compatible mouse (optional).
  37.  
  38.  
  39. Using FZEdit:
  40. ------------
  41.  
  42. FZEdit operates on FZCom files or in direct communication with the FZ-1/10M
  43. via MIDI.  A typical use is to edit the parameters currently residing in
  44. the FZ.  To download the FZ's parameters into FZEdit, invoke it as:
  45.  
  46.      FZEdit /D
  47.  
  48. As with FZCom, the FZ-1/10M must be using MIDI as its input/output device. 
  49. To set the device to MIDI, enter DATA_DUMP --> SELECT_DEVICE and change the
  50. device from DISK (or PORT) to MIDI.  On this same display, the following
  51. line contains the item REMOTE MODE.  After selecting MIDI as the device,
  52. use the downarrow key to put the cursor on REMOTE MODE.  This places the
  53. PC in charge of data transfers.
  54.  
  55. The default mode of FZEdit is to display all parameters, pausing at each
  56. display.  To continue to the next display, press the PgDn key (unless
  57. instructed otherwise).
  58.  
  59. When viewing a parameter or full dump file or downloaded FZ-1/10M parameters,
  60. FZEdit first displays the effect data, followed by the bank data for each
  61. bank, followed by the voice data for each voice.  At any paused display,
  62. pressing <PgDN> or <PgUP> will move forward or backward one display page.
  63. Pressing <Home> or <End> will move to the first or last display page,
  64. respectively.  To view the effect data, press E.  To view a particular
  65. bank, press B followed by the bank number and a <RETURN>.  Similarly, a
  66. particular voice can be displayed by pressing V followed by a voice number
  67. and a <RETURN>.  When there is only a single voice or bank, a number is not
  68. required.
  69.  
  70. Some display lines contain values enclosed in square brackets [].  These
  71. values are those reported on the FZ display, which are different than the
  72. internal values maintained within the FZ (the internal values are always
  73. printed first).  For example:
  74.  
  75.   Generator: 00096..01920  [0000;0096..0001;0896]  (2..53 ms)
  76.  
  77. The first numbers (00096..01920) are the actual parameter values, the
  78. second numbers are as shown on the FZ TRUNCATE display and the third
  79. numbers are the times in milliseconds.
  80.  
  81. Several displayed parameters cannot be set via the FZ display.  These
  82. parameter names are followed with an asterisk character.  For example:
  83.  
  84.      Attack:*    0000
  85.  
  86. To edit parameters displayed on the current screen, enter the MODIFY
  87. command (by pressing the M key).  A menu of available editing options
  88. will appear.  Bank displays also support GLOBAL editing of bank values
  89. (by pressing the G key).
  90.  
  91. Some of FZEdit's editing features are highly useful.  For example,
  92. specifying area splits using the FZ can be tedious.  FZEdit allows
  93. adjacent area pairs to be set simultaneously according to a specified
  94. overlap.  An overlap split can also be easily transposed while
  95. maintaining the overlap.
  96.  
  97. Other highly-useful features are global editing of bank data (such as
  98. setting the velocity, output channel, etc.  values of all voices in a
  99. bank in one operation) and exchange of banks, voices, or areas.  FZEdit
  100. allows you to easily reorder bank, area, and voice numbers.  When voices
  101. are exchanged FZEdit performs all bookkeeping to insure that all banks
  102. using the exchanged voices are also properly updated.
  103.  
  104. To upload the edited parameters back into the FZ, press the U key.
  105. Uploading parameter values is relatively fast (typically under a
  106. minute).  If the settings don't sound right, modify and upload them
  107. again (there is no need to download them again).
  108.  
  109. When viewing parameters, a status window is often displayed at the lower
  110. right hand corner of the screen.  This window indicates the following:
  111.  
  112.   * the type of data being edited
  113.         F -- full dump
  114.         B -- bank dump
  115.         V -- voice dump
  116.         E -- effect dump
  117.         P -- parameter dump;
  118.   * whether or not global, group, and modification operations are available
  119.     (indicated by the letters A, G, and M);
  120.   * whether or not condensed and wide display modes are active
  121.     (indicated by the letters C and W);
  122.   * the current MIDI channel number for exchanging parameter data
  123.     with the FZ.
  124.  
  125. The mode indicators in the status window are displayed in upper case
  126. when the mode is enabled, and in lower case when the mode is disabled.
  127. Thus a status window containing ``P agM Cw  16'' indicates a parameter
  128. dump, global and group editing unavailable, modification editing
  129. available, condensed mode  active, wide display mode inactive, and a
  130. MIDI transfer channel of 16.
  131.  
  132. Whenever the status window is displayed at the lower right, a number of
  133. FZEdit commands are available.  A listing of these commands can be
  134. displayed by pressing the ``?'' key.
  135.  
  136.  
  137. Command Line Summary:
  138. --------------------
  139.  
  140. FZEdit supports a number of command line options:
  141.  
  142.      FZEdit {option}* [input-filename] {option}*
  143.  
  144. where a number of command line options (described below) can appear before
  145. or after with the (optional) input filename.  These options are for 
  146. convenience, as they can also be specifed within FZEdit. At most one input
  147. filename can be specified. 
  148.  
  149. Here are the command line parameters:
  150.  
  151.   /? or        Displays a brief summary of these commands.
  152.   /H
  153.  
  154.   /C           Condensed display mode: displays full, parameter, or bank data 
  155.                with voice summaries rather than complete parameters.
  156.  
  157.   /D           Changes from FZCom input file mode to FZ-1/10M MIDI parameter
  158.                download mode (using MIDI Channel 0).
  159.   /Dnn         Changes from FZCom input file mode to FZ-1/10M MIDI parameter
  160.                download mode (using MIDI Channel n).
  161.  
  162.   /L           Routes output to a listing file named either ``filename'' with
  163.   /Lfilename   extension *.FZL or, if not supplied, with the same name as the
  164.                input file with extension *.FZL.
  165.  
  166.   /Pxxxx       Set MIDI port base address (default 0330; xxxx = hex value).
  167.  
  168.   /W           Changes from the default 80 column mode to wide mode.
  169.  
  170.    The following commands change the default file extension from *.FZP
  171. (ignored when in MIDI parameter download mode):
  172.  
  173.   /TB          Changes the default input file extension to *.FZB.
  174.   /TE          Changes the default input file extension to *.FZE.
  175.   /TF          Changes the default input file extension to *.FZF.
  176.   /TV          Changes the default input file extension to *.FZV.
  177.  
  178. Note that command line parameters are insensitive to case and can be prefixed
  179. with either a hypen or a slash character.
  180.  
  181. Here is an example of a complex command line:
  182.  
  183.     FZEdit wildfx -tb -c -lfzcat
  184.  
  185. which places a compressed listing in file FZCAT.FZL of the parameters
  186. contained in FZCom file WILDFX.FZB.
  187.  
  188.  
  189. User Interface Editing Options:
  190. ------------------------------
  191.  
  192. When a value is required in an input window, the following editing commands
  193. are available:
  194.  
  195.      <ESC>       abort input operation;
  196.      <BkSp>      delete previous character;
  197.      <Ins>       toggle insert mode;
  198.      <Del>       delete current character;
  199.      leftarrow   move cursor left one character;
  200.      rightarrow  move cursor left one character;
  201.      <Return>    return the input value.
  202.  
  203. A number of the input windows in FZEdit support advanced editing features.
  204. When a default numeric value is given for an input option, the default can
  205. be selected by simply pressing the <RETURN> key.  The numeric value can be
  206. incremented by one using the uparrow cursor key or decremented by one using
  207. the downarrow cursor key.  The <PgUp> key increments the value by 10, and
  208. <PgDn> decrements the value by 10.  Finally, <Home> increments the value
  209. to its legal maximum, and <End> to its legal minimum.
  210.  
  211. Any other key removes the default value and converts the window to  a
  212. normal editing input window.
  213.  
  214.  
  215. Disclaimers:
  216. -----------
  217.  
  218. FZEdit is provided as is, with all the usual liability disclaimers as to
  219. correctness, suitability of purpose, etc.  The person(s) using the
  220. software bear all risk as to the quality and performance of the
  221. software.  In no event shall the author's liability for any damages ever
  222. exceed the price paid for the license to use the software, regardless of
  223. the form of the claim.
  224.  
  225. You may copy and redistribute FZEdit provided the program and this
  226. accompanying documentation are both included without modification.  Due
  227. to the number of different parameter values on the FZ, it is possible
  228. that FZEdit may incorrectly display some obscure parameter setting.  If
  229. you find such an error, please contact me.
  230.  
  231. FZEdit is SHAREWARE.  IT IS NOT FREE OR PUBLIC DOMAIN.  
  232.  
  233. If you paid to receive a disk containing FZEdit from other than the
  234. author or to access a network from which you downloaded FZEdit, you are
  235. NOT registered.  If you received a copy from a registered friend, you
  236. are also NOT registered.
  237.  
  238. If you use FZEdit, please register your copy by completing and returning
  239. the enclosed registration form.
  240.  
  241. The number of FZ-1/10M units out there is small compared to ``mainstream''
  242. instruments.  The lack of FZ-1/10M software is the result of this small
  243. market and the complexity of the FZ.  If you are using FZ shareware 
  244. programs without registration, you are not helping to change this
  245. situation.  
  246.  
  247. Support shareware and non-copy-protected software by paying your fair
  248. share.
  249.  
  250.  
  251. Dan Corkill                                 Corkill on MIDI-Net
  252. 9 Bristol Lane                              Cork on PAN
  253. Hadley, Massachusetts 01035                 72330,226 on CompUServe
  254.                                             D.CORKILL on GEnie
  255.  
  256. -------------------------------------------------------------------------------
  257.  
  258.                          FZEdit Registration Form
  259.  
  260.  
  261. Name:    ______________________________________________________________________
  262.  
  263.  
  264. Address: ______________________________________________________________________
  265.  
  266.  
  267. City/State: ___________________________________________  Zipcode: _____________
  268.  
  269.  
  270.                                        Today's Date: __________________________
  271.  
  272. Registration Fee:  ____ $35
  273.  
  274. FZList Upgrade:    ____ $10
  275.  
  276.  
  277. Return this form and $35 (or $10 upgrade) to:
  278.  
  279.      Dan Corkill
  280.      9 Bristol Lane
  281.      Hadley, Massachusetts 01035
  282.  
  283. -------------------------------------------------------------------------------
  284. End of File